<!DOCTYPE html>
<html>

<head>
	<meta charset="utf-8">
	<meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1">
	<meta name="theme-color" content="#33474d">
	<title>Nginx的rewrite应用 | 失落的乐章</title>
	<link rel="stylesheet" href="/css/style.css" />
	
      <link rel="alternate" href="/atom.xml" title="失落的乐章" type="application/atom+xml">
    
</head>

<body>

	<header class="header">
		<nav class="header__nav">
			
				<a href="/archives" class="header__link">Archive</a>
			
				<a href="/tags" class="header__link">Tags</a>
			
				<a href="/atom.xml" class="header__link">RSS</a>
			
		</nav>
		<h1 class="header__title"><a href="/">失落的乐章</a></h1>
		<h2 class="header__subtitle">技术面前，永远都是学生。</h2>
	</header>

	<main>
		<article>
	
		<h1>Nginx的rewrite应用</h1>
	
	<div class="article__infos">
		<span class="article__date">2017-10-12</span><br />
		
		
			<span class="article__tags">
			  	<a class="article__tag-link" href="/tags/LNMP/">LNMP</a> <a class="article__tag-link" href="/tags/Nginx/">Nginx</a>
			</span>
		
	</div>

	

	
		<p>&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;Rewrite主要的功能是实现URL重写，Nginx 的 Rewrite 规则采用 PCRE Perl 兼容正则表达式的语法进行规则匹配，如相使用 Nginx 的 Rewrite 功能，在编译 Nginx 前要编译安装 PCRE 库。</p>
<h2 id="一、Nginx使用if进行条件匹配"><a href="#一、Nginx使用if进行条件匹配" class="headerlink" title="一、Nginx使用if进行条件匹配"></a>一、Nginx使用if进行条件匹配</h2><p>&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;Nginx可以用if进行条件匹配，语法规则类似C</p>
<figure class="highlight bash"><table><tr><td class="gutter"><pre><div class="line">1</div></pre></td><td class="code"><pre><div class="line"><span class="keyword">if</span> （条件）&#123;...&#125; ( 可用于： server,location )</div></pre></td></tr></table></figure>
<p>&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;检查一个条件是否符合，如果条件符合，则执行大括号内的语句。不支持嵌套，不支持多条件 &amp;&amp; || </p>
<p>&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;例如：if ($http_user_agent ~ MSIE) {rewrite  ^(.*)$  /msie/$1  break;}</p>
<ol>
<li>正则表达式匹配，其中：</li>
</ol>
<ul>
<li>~  为区分大小写匹配 </li>
<li>~* 为不区分大小写匹配 </li>
<li>!~和!~*分别为区分大小写不匹配及不区分大小写不匹配</li>
</ul>
<ol>
<li>文件及目录匹配，其中：</li>
</ol>
<ul>
<li>-f和!-f用来判断是否存在文件 </li>
<li>-d和!-d用来判断是否存在目录 </li>
<li>-e和!-e用来判断是否存在文件或目录 </li>
<li>-x和!-x用来判断文件是否可执行</li>
</ul>
<p>&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;例如：if (!-f $request_filename) {proxy_pass  <a href="http://127.0.0.1;}" target="_blank" rel="external">http://127.0.0.1;}</a></p>
<p>&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;Wordpress的重定向规则：</p>
<figure class="highlight bash"><table><tr><td class="gutter"><pre><div class="line">1</div></pre></td><td class="code"><pre><div class="line"><span class="keyword">if</span> (!-e <span class="variable">$request_filename</span>) &#123;rewrite ^/(index|atom|rsd)\.xml$ http://feed.shunz.net last;rewrite ^([_0-9a-zA-Z-]+)?(/wp-.*) <span class="variable">$2</span> last;rewrite ^([_0-9a-zA-Z-]+)?(/.*\.php)$ <span class="variable">$2</span> last;rewrite ^ /index.php last;&#125;</div></pre></td></tr></table></figure>
<p>&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;return ( 可用于： server,location,if )  ## 用于结束规则的执行并反回状态码给客户端。  状态码可以是 ：204/400/402~406/408/410/411/413/416/500~504  </p>
<p>&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;如：</p>
<figure class="highlight bash"><table><tr><td class="gutter"><pre><div class="line">1</div><div class="line">2</div><div class="line">3</div></pre></td><td class="code"><pre><div class="line">location ~ .*\.(sh|bash)?$ &#123;  </div><div class="line">      <span class="built_in">return</span> 403;  </div><div class="line">    &#125;</div></pre></td></tr></table></figure>
<p>&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;访问的 URL 以 .sh .bash 结尾的，则返回 403 。</p>
<ul>
<li>204  No Content  </li>
<li>400  Bad Request  </li>
<li>402  Payment Required  </li>
<li>403  Forbidden  </li>
<li>404  Not Found  </li>
<li>405  Method Not Allowed  </li>
<li>406  Not Acceptable  </li>
<li>408  Request Timeout  </li>
<li>410  Gone  </li>
<li>411  Length Required  </li>
<li>413  Request Entity Too Large  </li>
<li>416  Requested Range Not Satisfiable  </li>
<li>500  Internal Server Error  </li>
<li>501  Not Implemented  </li>
<li>502  Bad Gateway  </li>
<li>503  Service Unavailable  </li>
<li>504  Gateway Timeout </li>
</ul>
<h2 id="二、Nginx使用rewrite"><a href="#二、Nginx使用rewrite" class="headerlink" title="二、Nginx使用rewrite"></a>二、Nginx使用rewrite</h2><p>&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;rewrite ( 可用于： server,location,if ) ## 重写 URL ，或修改字符串。重写 URL 只对相对路径有效，如想对主机名，要使用 if 语句。 </p>
<p>&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;例1：</p>
<figure class="highlight bash"><table><tr><td class="gutter"><pre><div class="line">1</div><div class="line">2</div><div class="line">3</div><div class="line">4</div></pre></td><td class="code"><pre><div class="line"><span class="keyword">if</span> (<span class="variable">$host</span> ~* www\.(.*)) &#123;  </div><div class="line">      <span class="built_in">set</span> <span class="variable">$host_without_www</span> <span class="variable">$1</span>;  </div><div class="line">      rewrite ^(.*)$ http://<span class="variable">$host_without_www</span><span class="variable">$1</span> permanent;  </div><div class="line">&#125;</div></pre></td></tr></table></figure>
<p>&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;如果替换串以 http:// 开头，将会采用 301 或 302 跳转进行 URL 重定向。 </p>
<p>&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;例2：</p>
<figure class="highlight bash"><table><tr><td class="gutter"><pre><div class="line">1</div></pre></td><td class="code"><pre><div class="line">rewrite ^/feed/$ http://feed.shunz.net last;</div></pre></td></tr></table></figure>
<p>&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;Nginx的Rewrite规则与Apache几乎完全一致，所不同的是最后的flag标记，Nginx的rewrite指令后支持的标记有last，break，redirect，permanent</p>
<ul>
<li>last 相当于Apache里的[L]标记，表示完成rewrite，不再匹配后面的规则 </li>
<li>break ( 可用于： server,location,if ) ## 本条规则匹配完成后，终止匹配，不再匹配后面的规则<br>如：rewrite ^/b/(.*).html /play.php?video=$1 break; </li>
<li>redirect 返回302临时重定向,浏览器会显示跳转后的URL地址</li>
<li>permanent 返回301永久重定向，浏览器会显示跳转后的URL地址</li>
</ul>
<p>&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;last/break用来实现URL重写，浏览器地址栏的URL不变，但在服务器端访问的路径发生了变化。</p>
<p>&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;redirect/permanent实现URL跳转，浏览器地址栏URL会显示跳转后的URL。</p>
<p>&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;使用 alias 指令时必须用 last 标记 ，使用 proxy_pass 指令时要用 break 表示。 last 标记在本条 rewrite 规则执行完毕后，会对其所在 server{….}标签重新发起请 求，而 break 标记则在本条规则匹配完成后，终止匹配。  </p>
<p>&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;如：</p>
<figure class="highlight bash"><table><tr><td class="gutter"><pre><div class="line">1</div><div class="line">2</div><div class="line">3</div><div class="line">4</div></pre></td><td class="code"><pre><div class="line">location /cms/ &#123;  </div><div class="line">      proxy_pass http://test.abc.com;  </div><div class="line">      rewrite <span class="string">"^/cms/(.*)\.html$"</span> /cms/index.html <span class="built_in">break</span>;  </div><div class="line">&#125;</div></pre></td></tr></table></figure>
<p>&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;这条规则如果使用 last 会导致死循环。  </p>
<p>&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;一般在根 location 中（即 location / {….}）或直接在 server 标签编写 rewrite 规则，推荐使用 last 标记，  </p>
<p>&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;在非根 location 中 (即 location /cms/ {…}),则使用 break 标记。 </p>
<h2 id="Nginx-document-uri参数的使用"><a href="#Nginx-document-uri参数的使用" class="headerlink" title="Nginx $document_uri参数的使用"></a>Nginx $document_uri参数的使用</h2><p>&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;$document_uri  表示访问的url 现在我的需求是，访问 www.abc.com  请求到 www.abc.com/abc/</p>
<p>&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;在nginx配置文件中加入</p>
<figure class="highlight bash"><table><tr><td class="gutter"><pre><div class="line">1</div><div class="line">2</div><div class="line">3</div><div class="line">4</div></pre></td><td class="code"><pre><div class="line"><span class="keyword">if</span> (<span class="variable">$document_uri</span> !~ <span class="string">'abc'</span>)</div><div class="line">    &#123;</div><div class="line">            rewrite ^/(.*)$ http://www.abc.com/abc/<span class="variable">$1</span> permanent;</div><div class="line">    &#125;</div></pre></td></tr></table></figure>
<p>&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;而不是单独加一句  rewrite ^/(.*)$ <a href="http://www.abc.com/abc/$1" target="_blank" rel="external">http://www.abc.com/abc/$1</a> permanent;</p>
<p>&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;如果只加rewrite 规则，而不限定条件，那么会造成死循环。  会访问到   <a href="http://www.abc.com/abc/abc/abc/abc/" target="_blank" rel="external">http://www.abc.com/abc/abc/abc/abc/</a>….</p>

	

	
		<span class="different-posts"><a href="/2017/10/12/Nginx/24. Nginx的rewrite应用/" onclick="window.history.go(-1); return false;">⬅️ Go back </a></span>

	

</article>

	</main>

	<footer class="footer">
	<div class="footer-content">
		
	      <div class="footer__element">
	<p>Hi there, <br />welcome to my Blog glad you found it. Have a look around, will you?</p>
</div>

	    
	      <div class="footer__element">
	<h5>Check out</h5>
	<ul class="footer-links">
		<li class="footer-links__link"><a href="/archives">Archive</a></li>
		
		  <li class="footer-links__link"><a href="/atom.xml">RSS</a></li>
	    
		<li class="footer-links__link"><a href="/about">about page</a></li>
		<li class="footer-links__link"><a href="/tags">Tags</a></li>
		<li class="footer-links__link"><a href="/categories">Categories</a></li>
	</ul>
</div>

	    

		<div class="footer-credit">
			<span>© 2017 失落的乐章 | Powered by <a href="https://hexo.io/">Hexo</a> | Theme <a href="https://github.com/HoverBaum/meilidu-hexo">MeiliDu</a></span>
		</div>

	</div>


</footer>



</body>

</html>
